home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / fmsck20.zip / FMSCHECK.DOC < prev    next >
Text File  |  1989-10-18  |  12KB  |  339 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                          T H E    F M S   C H E C K E R
  17.  
  18.                                  Version  2 . 0
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                    Written By
  26.  
  27.                                    Ethan Poole
  28.  
  29.  
  30.                                   P.O. Box 1090
  31.                              Trenton, FL  32693-1090
  32.                              [voice] (904) 463-6108
  33.  
  34.                             The EHP Software Exchange
  35.                               [data] (904) 463-0027
  36.                                300/1200/2400 Baud
  37.                                  24 hrs, 7-days
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                 October 17, 1989
  45.  
  46. THE FMS CHECKER 2.0        Written by: Ethan Poole       EHP Software
  47. Exchange
  48. Dedicated to the Exchange of ShareWare and PD Software.  [data] (904)
  49. 463-0027
  50. =============================================================================
  51. =
  52.  
  53. This Program Consists of the Following Files:
  54.  
  55.    o  FMSCHECK.EXE   --- The Executable File
  56.                             (Compiled with QB 4.5)
  57.  
  58.    o  FMSCHECK.BAS   --- QuickBASIC Source Code
  59.  
  60.    o  FMSCHECK.DOC   --- This Text File
  61.  
  62.    o  WARNING.DOC    --- Please read!
  63.  
  64. If you do not have all these files, then you may download the latest version
  65. from my board at [data] (904) 463-0027, 24-hours a day.
  66.  
  67. I designed this program basically because there were no other programs at the
  68. time that could handle my own particulary needs (notice I've included the
  69. Source
  70. Code so that you won't fall into my own dilemma).
  71.  
  72. FMSCHECK 2.0 does not support chained FMS's although I believe you could
  73. achieve
  74. the same results by merely running FMSCHECK multiple times with different
  75. Configuration files (TFMSC.CFG in current directory is default).  You may
  76. feel
  77. free to modify it to do so if you feel the need (please send me or upload to
  78. me
  79. a copy of your modifications so that I may consider them in future
  80. revisions)!
  81.  
  82. It does, however, support extended descriptions (lines beginning with one or
  83. two
  84. spaces), RBBS-PC's special file security (line begins w/ =filename.zip ....
  85. 10
  86. description--meaning file is only viewable and downloadable by those w/ a
  87. security level of 10 or greater), SysOp-Only files and descriptions (lines
  88. starts with a "/"), and plain Comment lines (lines beginning with an "*").
  89.  
  90.  
  91. Purpose:
  92. ========
  93.  
  94. The purpose of FMSCHECK is to verify that each file in your FMS MASTER DIR
  95. actually exists in one of your Download Directories and if it exists to
  96. verify
  97. that the corect filesize is in the list.  If the file can not be found it
  98. will
  99. be logged to the specified error log file with the notation
  100. "filename.ext<--File
  101. Not Found!" and will not be included in the corrected FMS MASTER DIR LIST. 
  102. If
  103. the file size is in error then it will be corrected and inserted in place of
  104. the
  105. old file size in the corrected FMS MASTER DIR LIST and a comment with the
  106. notation "filename.ext.....<File Size Adjusted>" will be added to the Error
  107. Log
  108. file you specified.
  109.  
  110. One great application for a program of this nature is a SysOp who has just
  111. reZIPped a few thousand files with the latest Compression Utility (like
  112. upgrading from PK ZIP 0.92 to PK ZIP 1.01) and would very much like to update
  113. the filesizes in his/her FMS MASTER DIR to reflect the reduction in file
  114. sizes
  115. but is just overwhelmed at the prospect of having to re-enter all the file
  116. sizes
  117. by hand!  This program will do the dirty work for you!  On top of that it
  118. will
  119. even notify you of files that you claim to have in your FMS MASTER DIR but
  120. which
  121. do not exist in your Download Directories.
  122.  
  123.  
  124.  
  125.                                      Page  1
  126. THE FMS CHECKER 2.0        Written by: Ethan Poole       EHP Software
  127. Exchange
  128. Dedicated to the Exchange of ShareWare and PD Software.  [data] (904)
  129. 463-0027
  130. =============================================================================
  131. =
  132.  
  133. Limitations:
  134. ============
  135.  
  136.    o  Must not have more than 100 Download Directories (Source Code could be
  137.       modified to handle more if your really need it)
  138.  
  139.    o  The filenames must be in spaces 1-13 of the fms directory with no
  140. leading
  141.       spaces, slashes, or asterisks ("*").
  142.  
  143.    o  File sizes must be in spaces 14-22.  If a value of zero is found to
  144.       be in these spaces (either you entered a "0" or a word like "varies"
  145.       or is left blank) the file size will remain as you set it and will not
  146.       be adjusted.  File Sizes also should not exceed 2 Gigabytes!
  147.  
  148.    o  Date, Description, and Cat Code should begin at or after position 24.
  149.       Length of Description field is unimportant to this program, it copies
  150.       all remaining characters on the line following filename and file size
  151.       to the output file.
  152.  
  153.    o  Extended Descriptions must not exceed 23 lines in length.
  154.  
  155. *NOTE:  Any problems you may discover in your usage of this program should be
  156.         reported to my by either [voice] (904) 463-6108 or [data] (904) 463-
  157.         0027 so that I may fix them.
  158.  
  159.  
  160. DOS COMMAND LINE USAGE:
  161. =======================
  162.  
  163.    USAGE:  [drive:\path\]FMSCHECK [drive:\path\config.fil]
  164.  
  165.    where optional parameter [drive:\path\config.fil] is the Drive, Path, and
  166.    File Name containing the Configuration file for FMSCHECK.  If no optional
  167.    parameters are entered (i.e. A:> FMSCHECK <ENTER KEY>) the default is     
  168.    TFMSC.CFG in present directory.
  169.  
  170. FIRST TIME:
  171. ===========
  172.  
  173. Copy FMSCHECK.EXE to your RBBS directory and type FMSCHECK and press enter. 
  174. If
  175. this is your first time running FMS CHECK in this Directory then you will be
  176. prompted to enter the necessary configuration information.
  177.  
  178.    EXAMPLE:
  179.  
  180.              Drive, Path, and Filename for FMS MASTER DIR: 
  181. c:\dirs\master.dir
  182.        Drive, Path, and Filename for Corrected MASTER DIR: 
  183. c:\dirs\master.new
  184.                Drive, Path, and Filename to Log Errors to:  c:\dirs\Error.Log
  185.     Drive,  Path, and Filename to Append SysOp-Only Lines:  c:\dirs\sysop.dir
  186.     Do You wish 'MOVE SYSOP-ONLY LINE' Default to be Yes (Y/N)?  y
  187.  
  188.     Drive and Directory Containing DL Files (or END to Quit):  c:\rbbs\utils
  189.     Drive and Directory Containing DL Files (or END to Quit):  c:\rbbs\comm
  190.     Drive and Directory Containing DL Files (or END to Quit): 
  191. c:\rbbs\bbs      
  192.                                       \/
  193.                              up to 97 more directories*
  194.                                      Page  2
  195. THE FMS CHECKER 2.0        Written by: Ethan Poole       EHP Software
  196. Exchange
  197. Dedicated to the Exchange of ShareWare and PD Software.  [data] (904)
  198. 463-0027
  199. =============================================================================
  200. =  
  201.                                      .
  202.                                        .
  203.                                        .
  204.    Drive and Directory Containing DL Files (or END to Quit):  END
  205.  
  206. *NOTE:  Typing "END" or pressing the Enter key by itself will automatically
  207.         end the request for DL directories.
  208.  
  209. *ALSO*: You should not use the same input or output filenames more than once,
  210.         FMSCHECK does not allow this and will only return you to the SETUP
  211.         screen if you make this error!
  212.  
  213. For the sake of efficiency you should try to enter your directories in order
  214. of
  215. size, directory containing largest number of files first...smallest directory
  216. last.  This way FMSCHECK does not have to waste as much time looking for the
  217. majority of the files because it will hit on them in the first few tries
  218. rather
  219. than going all the way trough to the last dir.
  220.  
  221.  
  222. You should see the Intro screen next, it lasts about 5 seconds, followed by a
  223. screen allowing you 5 seconds to press 'Y' or 'N' if you wish it to move all
  224. SysOp-Only lines and descriptions it encounters to a seperate SysOp-Only
  225. Directory Listing, ignoring this indicates that you wish to leave all
  226. SysOp-Only
  227. ("/...") lines to your default, after which a status screen that shows you
  228. FMSCHECK in action.  The top line is displayed only for your convenience,
  229. mainly
  230. trouble-shooting, with everything but the category codes displayed.
  231.  
  232. If FMSCHECK encountered any errors you will be informed by the final screen
  233. and
  234. requested to view your error log, which will list the encountered errors.
  235.  
  236.  
  237. Modifications, Customizing, and Continued Use:
  238. ==============================================
  239.  
  240. (1)  Regardless of whether you register your copy, you are obligated to drop
  241.      me a 'line' and let me know what you think of this, and any of my other
  242.      utilities which you may have used.  I want to know if it was what you
  243.      expected it to be, if there were any problems and if you have any
  244.      suggestions for improvement in future versions!  If too few people
  245. express
  246.      an interest in this or other programs I write I will have to assume that
  247.      nobody considers them to be useful and that it is not worth my time and
  248.      trouble to update and release new versions in the future -- So PLEASE
  249. let
  250.      me know what YOU THINK!
  251.  
  252. (2)  I included the QuickBASIC Source Code so that you may customize this
  253.      software to meet *your* needs, however, if you customize, or just plain
  254.      use, the software and make frequent use of it, YOU *ARE OBLIGATED* TO
  255.      REGISTER YOUR COPY BY MAILING $15 (made payable to ETHAN POOLE) TO the
  256.      following ADDRESS:
  257.                                    Ethan Poole
  258.                             The EHP Software Exchange
  259.                                   P.O. Box 1090
  260.                              Trenton, FL  32693-1090
  261.  
  262. Please, if you use this software and appreciate it, send my the money, I need
  263. it
  264. so that I may expand my own BBS.  Besides, if you wrote a program, wouldn't
  265. you
  266. like at least a MINIMAL reimbursement for your trouble and expenses?!?!
  267.  
  268.                                     Page 3
  269. THE FMS CHECKER 2.0        Written by: Ethan Poole       EHP Software
  270. Exchange
  271. Dedicated to the Exchange of ShareWare and PD Software.  [data] (904)
  272. 463-0027
  273. =============================================================================
  274. =
  275.  
  276. Question and Comments:
  277. ======================
  278.  
  279. All questions and comments concerning FMSCHECK should be directed to Ethan
  280. Poole
  281.  
  282.    o  [voice] (904) 463-6108; 11 am - 10 pm (all returned calls will be
  283.       collect!)
  284.  
  285.    o  [data] (904) 463-0027; 24 hours, 7-days; 300/1200/2400 Baud
  286.  
  287.    o  or by FAX (904) 463-7666 (ATTN:  ETHAN POOLE)
  288.  
  289.  
  290.                  THANKS FOR YOUR SUPPORT...COMMENTS ARE WELCOME
  291.  
  292.                                Ethan Poole, SysOp
  293.  
  294.  
  295. History of Revisions:
  296. =====================
  297.  
  298. FMS Checker 1.0 -- 10/01/89 -- Did not delete extended descriptions which 
  299.                 belonged to non-existent [thus, deleted] files, could screw
  300.                 up the modified listing.
  301. FMS Checker 1.5 -- 10/09/89 -- Fixed FMS Extended Description Problem; added
  302.                 some additional formatting to the Error Log File; added,
  303.                 by request of Craig Kootsillas (of The C Line BBS [data 901-
  304.                 427-1680] Specializing in 'C' Programming), an option permit-
  305.                 ting you to tell FMS Checker to DELETE ALL SysOp-Only
  306.                 description lines (those lines beginning with a "/"; and
  307.                 setup FMS Checker to automatically copy all lines beginning
  308.                 with a "\" straight to the new file without trying to inter-
  309.                 pret it as a file and creating a listing in the Error Log
  310.                 file, but I still have not included support for chained dirs.
  311. FMS Checker 2.0 -- 10/17/89 -- SysOp-Only Lines may now be appended to a
  312.                 SysOp-Only Directory File.  Fixed incredibly stupid mistake
  313.                 which has been in the program since 1.0 -- forgot to set
  314. integer
  315.                 representing file length to be a LONG Integer, previous
  316. versions
  317.                 made no filelength corrections to files exceeding 32K in
  318. length.
  319.                 BETTER RE-CHECK YOUR FMS MASTER DIR WITH THIS RELEASE!  IT
  320. WILL
  321.                 PICK-UP WHERE 1.0 & 1.5 LEFT OFF!  Sorry about the mistake!
  322. FMS Checker x.x -- 00/00/00 -- Still waiting for YOUR Input!
  323.  
  324.                 
  325.  
  326.  
  327.  
  328.  
  329.  
  330. P.S.--Why don't you give The EHP Software Exchange a Try.
  331.       Dial (904) 463-0027 Today!
  332.  
  333.  
  334.  
  335. ehp/10/09/89
  336.  
  337.  
  338.                                     Page 4
  339.